.TH XCUECAT 1
.SH NAME
.B xcuecat
\- GUI X interface to the :Cue:Cat\*(Tm wand scanner.
.SH SYNOPSIS
.B xcuecat
[
.I file
]
.SH DESCRIPTION
The
.B xcuecat
script opens an X dialog to allow the user to interact with the
:Cue:Cat\*(Tm  wand scanner.
The
.I file
argument, if present, is used for the initial configuration file. If
it is not present, then
.B .xcuecat
in the users home directory will be used.
.P
The top part of the dialog - labeled
.I Bar code
- has an entry area labeled
.BR Scan .
To start a scan, activate this area, and then scan a bar code with the
:Cue:Cat\*(Tm scanner.
After a successful scan, the bar code proper is displayed in the area labeled
.BR Code ,
and the type of the bar code in the area labeled
.BR Type .
The
.B Code
area is selected, and may be pasted into another application
immediately after the scan.
.P
The second part of the dialog - labeled
.I Filter -
is a radio selection controlling the translation of the scan. If
.B None
is selected, the scan will be translated into an EAN13 type code.
If
.B ISBN
is selected, then the scan will be translated into an International
Serial Book Number type code if that is possible. If any other type of
bar code is scanned, the scan will not be considered successful.  If
.B UPC
is selected, than the scan will be translated into a Universal Product
code if that is possible. Any other type of bar code scanned will fail.
.P
The third section - labeled
.I State
- controls the behavior of the Gui. The checkbox labeled
.B Beep after scan
will cause a successful scan to generate audible feedback if it is
checked . The checkbox labeled
.B Balloon help
will enable balloon help if it is checked.
Finally, the entry area labeled
.B Command
can be used to enter a shell command to be executed after a successful
scan. It should have a single
.RB \*(lq %s \*(rq
which will be replaced by the code resulting from the scan before
being passed to the shell. To get a single
.RB \*(lq % \*(rq
in the command, use
.RB \*(lq %% \*(rq "" .
See the 
.BR cuecat (1)
manual page for example commands.
.P
The next to last part of the dialog has three buttons,
.BR Load ,
.BR Save ,
and
.BR Exit .
.B Load
and
.B Save
open dialogs to load and save the configuration file, defaulting to the
current configuration file. After the file is loaded or saved, it
becomes the current configuration file. The
.B Exit
button will save the current configuration to the current
configuration file and then exit. If the window manager is used to
close the window, the application will exit without saving the current
configuration.
.P
If the operating system cooperates, the saved configuration files will
be executable. Running them will run xcuecat using that configuration
file. For this to work, the operating system must support
.I #!
executables, must have a
.BR env (1)
command, and the 
.B envName
attribute of the Scanner class in xcuecat must match. This may need to
be edited for your operating system.
.P
The last part of the dialog is an unlabeled message area where longer
help messages and the results of various actions are displayed.
.SH SEE ALSO
.BR cuecat (1)
.BR env (1)